home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1994 2nd Q2 / The Association of Shareware Professionals - The Official ASP Advantage (2nd Quarter)(1994).bin / files / progming / sppbc3 / read.me < prev    next >
Encoding:
Text File  |  1992-05-10  |  10.9 KB  |  262 lines
  1.  
  2.      Serial++ Library Ver. 1.10
  3.      --------------------------
  4.      
  5.      Serial Communications Support for Borland C++
  6.      Quality Software from Cortlandt Technologies.
  7.  
  8.      Copyright (c) 1991,1992 Cortlandt Technologies. All rights reserved.
  9.  
  10.  
  11.      Introduction:
  12.      -------------
  13.  
  14.      Serial++ is a library of small, safe, and efficient routines
  15.      that bring interrupt driven serial port support to your
  16.      C++ programs compiled and linked with the Borland C++ compiler.
  17.  
  18.      The routines in Serial++ are as easy to use as console i/o in C,
  19.      yet give you complete access to the registers of the 8250 UART,
  20.      should your program require it.
  21.  
  22.      Implemented as C++ classes, the Serial++ library handles multiple 
  23.      ports and multiple instantiations with ease.
  24.  
  25.      Finally, Serial++ is protected against keyboard breaks, to insure 
  26.      that any application that uses communications can complete the
  27.      necessary housekeeping before terminating. You can also use the 
  28.      break trapping provided with Serial++ in you own programs,
  29.      independtly from the port support.
  30.  
  31.      Serial++ is linked into your Borland C++ programs just like any
  32.      other library... there are no TSR's or assembly coding required.
  33.  
  34.      Note:
  35.      -----
  36.  
  37.      USERS OF SPP VERSIONS PRIOR TO 1.1 WILL HAVE TO RECOMPILE THEIR
  38.      SOURCE CODE WITH THIS RELEASE.
  39.      
  40.      
  41.      Installation:
  42.      -------------
  43.  
  44.      Serial++ is contained in a self-extracting compressed file,
  45.      named SPPBC?.EXE.  There are two versions of this file, one for
  46.      Version 2.0 of the Borland C++ compiler, and one for all variations
  47.      on BC++ Version 3.x.
  48.      
  49.      Copy this appropriate version of the SPPBC?.EXE file to the directory 
  50.      where you plan to be compiling and linking your code, and run it.
  51.  
  52.      The file named PACKING.LST contains a list of all the files that
  53.      are included with Serial++, and a brief description of each.
  54.  
  55.      Serial++ expects to find its include files, SERIAL.H and BREAK.H,
  56.      and its library files, SPP?.LIB, in the compiler's search path.
  57.      There are several ways to accomplish this, the easiest of which
  58.      is to copy these files into the directory where you compile your
  59.      source.
  60.  
  61.      For other approaches, see the manual on this topic.
  62.  
  63.  
  64.      Documentation:
  65.      --------------
  66.  
  67.      In addition to this file, you will find two other documentation files
  68.      in this package.  PACKING.LST lists all the files that make up this
  69.      package, along with a description of each.
  70.  
  71.      SPPMAN.TXT is an ASCII image of the Serial++ manual, ready to print
  72.      on any 66 lines/page printer setup. To print the manual, ready your
  73.      printer, and then issue this command:
  74.  
  75.            C:>copy SPPMAN.TXT PRN:
  76.  
  77.      The manual contains the only complete function reference in the 
  78.      package.  It is about fifty pages long.
  79.  
  80.  
  81.      Getting Started:
  82.      ----------------
  83.  
  84.      The easiest way to get started with Serial++ is to take a look at the
  85.      simple demo program supplied: SPPDEMO.EXE. Source code for this
  86.      program, along with a make file (for Borland make) are included.
  87.  
  88.      This program allows you to carry on a simple conversation with the
  89.      com port of your choice, setting the port, speed, and other parameters
  90.      from the command line. Typing SPPDEMO without any parameters will
  91.      display this quick help message:
  92.  
  93.  
  94.            Type $$$ at prompt or press Ctrl-Break to exit.
  95.  
  96.            Usage: [sppdemo [port [baud [databits [parity [stopbits]]]]]]
  97.  
  98.                port = COM1 | COM2
  99.                baud = 2400 | 1200 | 300
  100.            databits =    8 |    7
  101.              parity = NONE | EVEN | ODD
  102.            stopbits =    1 |    2
  103.  
  104.            Example (defaults):   sppdemo COM1 1200 8 N 1
  105.  
  106.  
  107.      Serial++ is Shareware:
  108.      ----------------------
  109.  
  110.      Serial++ is being marketed as shareware, which means you have the
  111.      opportunity to evaluate this product before buying it, and you may
  112.      also distribute copies of it to others under certain conditions
  113.      explained below.
  114.      
  115.      Shareware distribution gives users a chance to try software before 
  116.      buying it. If you try a Shareware program and continue using it, you 
  117.      are expected to register. Individual programs differ on details 
  118.      -- some request registration while others require it, some specify a 
  119.      maximum trial period. With registration, you get anything from the 
  120.      simple right to continue using the software to an updated program with 
  121.      printed manual.
  122.  
  123.      Copyright laws apply to both Shareware and commercial software, and the 
  124.      copyright holder retains all rights, with a few specific exceptions as 
  125.      stated below. Shareware authors are accomplished programmers, just like 
  126.      commercial authors, and the programs are of comparable quality. 
  127.      (In both cases, there are good programs and bad ones!) The main 
  128.      difference is in the method of distribution. The author specifically 
  129.      grants the right to copy and distribute the software, either to all and 
  130.      sundry or to a specific group. For example, some authors require written
  131.      permission before a commercial disk vendor may copy their Shareware.
  132.  
  133.      Shareware is a distribution method, not a type of software. You should 
  134.      find software that suits your needs and pocketbook, whether it's 
  135.      commercial or Shareware. The Shareware system makes fitting your needs 
  136.      easier, because you can try before you buy. And because the overhead 
  137.      is low, prices are low also. Shareware has the ultimate money-back 
  138.      guarantee -- if you don't use the product, you don't pay for it.
  139.  
  140.      Note that no capabilities or features are left out of this evaluation
  141.      copy -- this is a complete fully functional release of Serial++.
  142.  
  143.      
  144.      Registering Serial++
  145.      --------------------
  146.  
  147.      If you like Serial++ and wish to continue using it after a 30-day trial
  148.      period, you must pay the $24.95 registration fee.
  149.  
  150.      You MUST register Serial++ if you intend to distribute your own
  151.      software that uses it.  Once you have paid the one time registration
  152.      fee, there are no other royalties or restrictions on distributing
  153.      your own software that includes Serial++.
  154.  
  155.      Registration entitles you to a printed manual, complete C++ source,
  156.      license to distribute software you build using Serial++, technical
  157.      support by mail or via Compuserve for 1 year, and notice of
  158.      version upgrades and new product announcements.
  159.  
  160.      For complete details of Serial++ license and registration information,
  161.      please read the appropriate sections in the manual, SPPMAN.TXT.
  162.  
  163.    
  164.      Distributing Serial++
  165.      ---------------------
  166.  
  167.      Please distribute Serial++ in its original compressed file to
  168.      any interested friends and colleagues, and to upload it to any BBS's 
  169.      that you use.  
  170.      
  171.      If you distribute Serial++ via diskette, you may not charge anything
  172.      for the program, although you may impose whatever nominal charge is
  173.      required to pay for the disk media and handling.
  174.      
  175.      Anyone distributing Serial++ for any kind of remuneration must first 
  176.      contact Cortlandt Technologies at the address below for authorization.
  177.      This authorization will be automatically granted to distributors
  178.      recognized by the (ASP) as adhering to its guidelines for shareware 
  179.      distributors, and such distributors may begin offering Serial++ 
  180.      immediately (However Cortlandt Technologies must still be advised so
  181.      that the distributor can be kept up-to-date with the latest version of 
  182.      Serial++.).
  183.  
  184.      For complete details of the Serial++ limited distribution license 
  185.      please read the appropriate sections in the manual, SPPMAN.TXT.
  186.  
  187.  
  188.      Disclaimer:
  189.      -----------
  190.                  
  191.      Users of Serial++ must accept this disclaimer of warranty:
  192.      Serial++ is supplied as is.  The author disclaims all warranties, 
  193.      expressed or implied, including, without limitation, the warranties of 
  194.      merchantability and of fitness for any purpose. The author assumes no 
  195.      liability for damages, direct or consequential, which may result from 
  196.      the use of Serial++.
  197.  
  198.      
  199.      ASP:
  200.      ----
  201.                  
  202.      This program is produced by a member of the Association of
  203.      Shareware Professionals (ASP).  ASP wants to make sure that the
  204.      shareware principle works for you. If you are unable to resolve a
  205.      shareware-related problem with an ASP member by contacting the
  206.      memberdirectly, ASP may be able to help. The ASP Ombudsman can
  207.      help you resolve a dispute or problem with an ASP member, but
  208.      does not provide technical support for members' products.  Please
  209.      write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442
  210.      or send a CompuServe message via CompuServe Mail to ASP Ombudsman
  211.      70007,3536.
  212.  
  213.           
  214.      How to Register
  215.      ---------------
  216.  
  217.      You can register and receive your licensed Serial++ package direct 
  218.      from Cortlandt Technologies by using the form in file REGISTER.TXT
  219.      and sending $24.95 (plus applicable sales tax where appropriate) by
  220.      check or money order.
  221.  
  222.      If you prefer to use your credit card, you can order Serial++ from
  223.      Public (software) Library with your MC, Visa, AmEx or Discover card 
  224.      by calling 800-242-4PsL (overseas: 713-524-6394) or by FAX to 
  225.      713-524-6398, or by Compuserve to 71355,470.  Orders placed through
  226.      PsL are subject to an additional $4.00 shipping/handling charge (in
  227.      US, $15.00 overseas).
  228.  
  229.      These numbers are for ordering only, Cortlandt Technologies can NOT
  230.      be reached at them.  To contact Cortlandt Technologies for
  231.      any reason (including dealer pricing, volume discounts, site licensing,
  232.      status of orders, latest version info, technical information, or to
  233.      discuss returns), please use the information listed below.
  234.  
  235.  
  236.      And Finally...
  237.      --------------
  238.  
  239.      Thank you for taking the time to evaluate Serial++ and for supporting
  240.      the shareware concept.
  241.  
  242.      Please feel free to contact me if you have any questions about Serial++
  243.      or require additional information.
  244.  
  245.        Mike Aiello
  246.        Cortlandt Technologies
  247.        P.O. Box 195
  248.        Pleasantville, NY 10570
  249.  
  250.        Compuserve: 71066,155
  251.                                             _______
  252.                                        ____|__     |                (R)
  253.                                     --|       |    |-------------------
  254.                                       |   ____|__  |  Association of
  255.                                       |  |       |_|  Shareware
  256.                                       |__|   o   |    Professionals
  257.                                     -----|   |   |---------------------
  258.                                          |___|___|    MEMBER
  259.           
  260.           
  261. 
  262.